Skip to content

ci: scope OpenSpec validation to feature changes - #1

Open
jamubc wants to merge 1 commit into
mainfrom
ci/scope-openspec-validation-to-features
Open

ci: scope OpenSpec validation to feature changes#1
jamubc wants to merge 1 commit into
mainfrom
ci/scope-openspec-validation-to-features

Conversation

@jamubc

@jamubc jamubc commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

Summary

The OpenSpec validation workflow currently demands the full change-proposal format (Why, What Changes, MODIFIED Requirements, SHALL/MUST, GIVEN/WHEN/THEN, numbered Verification) on every PR and issue across the org. That is right for feature work but wrong for docs, chore, and fix changes and for bug reports, which have no requirement delta. They get a red check and a needs-info label with no way to satisfy it honestly. This scopes the format to feature changes only.

Changes

  • validate-openspec.yml: skip the required-section checks unless the target is a feature (title feat: or branch feat/, or an issue labeled feature/enhancement). Non-feature targets pass and have any stale needs-info label cleared. The failure comment now states that non-feature changes are exempt.
  • CONTRIBUTING.md: document when the OpenSpec format applies and the exempt change types.
  • PULL_REQUEST_TEMPLATE.md: lead with a universal Summary / Changes / Verification, and move the spec sections into a clearly marked feature-only block to delete for non-feature PRs.

Verification

  • A docs/chore/fix PR (no feat: title, no feat/ branch) passes the OpenSpec check
  • A feat: PR still fails when it is missing required sections
  • A bug-report issue no longer gets the needs-info label
  • A PR that previously carried a stale needs-info label has it removed on the next edit

Docs, chore, fix, ci, test, refactor, style, build, and perf PRs and
issues carry no requirement delta, so they no longer need the OpenSpec
proposal sections. The validator now runs its required-section checks
only on feature changes (a feat: title or feat/ branch, or an issue
labeled feature/enhancement) and clears any stale needs-info label on
everything else. Update CONTRIBUTING and the PR template to match.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant